home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / gt_power / readr200.zip / READDR.DOC < prev    next >
Text File  |  1990-06-25  |  12KB  |  322 lines

  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.         READDRESS: v2.00                                by Stephen de Plater
  10.         June 24, 1990                                    GT Power Net: 302/1
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.                                      READDRESS
  19.                                 by Stephen de Plater
  20.                                 GT Power Net: 302/1
  21.                             Phone Voice: +61 2 977-3075
  22.                              Phone Data: +61 2 977-2013
  23.  
  24.  
  25.  
  26.  
  27.         ===================================================================
  28.         0.                         REVISION LIST
  29.         ===================================================================
  30.  
  31.         Just to confuse everyone this revision list begins at version 1.10
  32.  
  33.         VERSION:  Release Date:       Comments:
  34.         -------   ------------        ------------------------------------
  35.         1.10      May 24, 1988        Standard   Command   Line    Interface
  36.                                       Added. Command  line parameters  [/F],
  37.                                       [/Q], [/N], [/A] added (see below).
  38.  
  39.                                       Pathnames  removed, replaced  by  area
  40.                                       numbers.
  41.  
  42.         2.00      June 24, 1990       It's been a long time between drinks!
  43.  
  44.                                       Conversion  to GT15.xx  formats.  Port
  45.                                       to a new compiler (Turbo C++).
  46.  
  47.  
  48.         ===================================================================
  49.         1.                           COPYRIGHT
  50.         ===================================================================
  51.  
  52.         READDR  is  not  placed  in  the  Public  Domain.  The  copyright is
  53.         retained and the software is provided on licence:
  54.  
  55.         You are free to use and make  as many copies of this program  as you
  56.         wish. You may also give it away to anyone who wants it, provided:
  57.  
  58.         1.   No fee is charged.
  59.         2.   This archive is distributed intact.
  60.         3.   You register the package with an OZNET registration centre.
  61.  
  62.  
  63.  
  64.  
  65.                                     >> page 1 <<
  66.  
  67.  
  68.  
  69.  
  70.  
  71.  
  72.  
  73.         READDRESS: v2.00                                by Stephen de Plater
  74.         June 24, 1990                                    GT Power Net: 302/1
  75.  
  76.  
  77.  
  78.         ===================================================================
  79.         2.                          REGISTRATION
  80.         ===================================================================
  81.  
  82.         A  new  registration  scheme  now  applies  to  all OZNET  software.
  83.         Regardless of any  previous registration, this program now  requires
  84.         individual installation for each BBS using it.
  85.  
  86.         There  is still  NO fee  involved at  all. DO  NOT  send any  money!
  87.         Registration  simply involves  obtaining from  me  a CRC  code which
  88.         matches your BBS name.   You may do this at  any of the  seven OZNET
  89.         registration centres:
  90.  
  91.                   Kangaroo Korner          302/001   Stephen de Plater
  92.                   The Black Hole           302/003   Ken Thompson
  93.                   TSUNAMI! Catch the Wave  *TEMPDN   Chet Wilkinson
  94.                   Control Systems          071/001   Ed Cavender
  95.                   Gidget's Domain          081/005   Jack Hazel
  96.                   Fuzzy Logic              050/018   Phill Piddell
  97.                   The Gathering Place      093/000   Joe Tellup
  98.  
  99.         If you are in the  GTPN nodelist then you will  be able to  register
  100.         direct  online at any  of those  centres or via  mail in the correct
  101.         form to OZRobot at  any of those centres.  See the  included OZRobot
  102.         document for details.  If you are  not in the GTPN net you will need
  103.         to apply  via private  netmail or  message to  Sysop at  any of  the
  104.         centres.  Whatever way  you do it you will  need to supply  the full
  105.         (case sensitive) name to which you want the program registered.
  106.  
  107.         You  will also  need to obtain  the OZINSTAL  program which performs
  108.         the actual installation.   OZINSTAL is not included in this archive.
  109.         You should look for OZINST11.ZIP.
  110.  
  111.         PLEASE  NOTE: This program  will run  only in test  mode (see below)
  112.         until your registration key is installed.
  113.  
  114.  
  115.         ===================================================================
  116.         3.                            PURPOSE
  117.         ===================================================================
  118.  
  119.                         (Or what does this thing do anyway?)
  120.  
  121.         READDR is a companion program for GT Power BBS Systems.
  122.  
  123.         It is  designed to re-address mail  in your message  system. It will
  124.         simply change the name of the receiver in specific cases. 
  125.  
  126.  
  127.  
  128.  
  129.                                     >> page 2 <<
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.  
  137.         READDRESS: v2.00                                by Stephen de Plater
  138.         June 24, 1990                                    GT Power Net: 302/1
  139.  
  140.  
  141.  
  142.         ===================================================================
  143.         4.                             USAGE
  144.         ===================================================================
  145.  
  146.         To use READDR:
  147.  
  148.         1.   Install READDR.EXE in your DOS path.
  149.  
  150.         2.   Create  in your GTPATH directory a file containing the specific
  151.              readdressings  which are  to  be made.  The  file can  have any
  152.              name,  but the default is READDR.BBS.  It is an ascii file with
  153.              up to 500 lines in the following format:
  154.  
  155.                        Old Name > New Name
  156.  
  157.              The fields can begin in any columns. Case is not important.
  158.  
  159.              Whenever a message  addressed to "Old Name" is found, it is re-
  160.              addressed to "New Name".
  161.  
  162.              For instance, people find my  name difficult to spell,  so mail
  163.              arrives  here  addressed  to  a  quite  imaginative  series  of
  164.              variations.  I use READDR  to re-address  it all to  the name I
  165.              sign onto this  board under. Then  GT Power  will automatically
  166.              show  it all  to me. I  have a  READDR.BBS file  which contains
  167.              (among other things):
  168.  
  169.                        Steven Deplater > Stephen Deplater
  170.                        Steve Deplater > Stephen Deplater
  171.                        Sysop > Stephen Deplater
  172.                        .....
  173.  
  174.  
  175.              You could  also use  it to  bring other  people's mail  to your
  176.              attention,  e.g.  mail which  comes  in  to banned  or  deleted
  177.              users.
  178.  
  179.              Names will be automatically  adjusted for case,  and each  name
  180.              may consist of any number of words. 
  181.  
  182.         3.   If you  wish you may create  another ascii  file which contains
  183.              the names of  the message areas  which are to  be searched  for
  184.              re-addressing.  The file  may  have any  name  at all,  but the
  185.              default  is GTMDIR.BBS. It  must, however, reside in the GTPATH
  186.              directory. If no  file is  given then GTMDIR.BBS is  used--that
  187.              is,  it will  re-address through ALL  your message  areas. If a
  188.              file is given,  then its format is exactly  the same as that of
  189.              the  GTMDIR.BBS file.  In fact, the  easiest way  to create the
  190.              file you need is to copy the GTMDIR.BBS file and edit it down!
  191.  
  192.  
  193.                                     >> page 3 <<
  194.  
  195.  
  196.  
  197.  
  198.  
  199.  
  200.  
  201.         READDRESS: v2.00                                by Stephen de Plater
  202.         June 24, 1990                                    GT Power Net: 302/1
  203.  
  204.  
  205.  
  206.              In  general you  would probably want  to limit  the areas which
  207.              were  to  be  subject to  re-addressing.  For  instance,  it is
  208.              probably  a good  idea  to  prevent the  program  re-addressing
  209.              echomail areas--after all, there are many "Sysop"s and not  all
  210.              of them should have their names changed to yours!! I  limit the
  211.              scope  of this program  to local  conference and  netmail areas
  212.              only.
  213.  
  214.              Outbound  net-mail (mail  with a  destination  in the  net/node
  215.              areas of the control file) will NEVER be re-addressed.
  216.  
  217.  
  218.         ===================================================================
  219.         5.                           REPORTING
  220.         ===================================================================
  221.  
  222.         The  screen output may be redirected  to a file if you  need to save
  223.         the output  for examination later  on.  (As this  thing runs in  the
  224.         middle of  the night  I catch  the output  that way  ... although  I
  225.         generally don't bother to look at it <grin>.)
  226.  
  227.  
  228.         ===================================================================
  229.         6.                    COMMAND LINE PARAMETERS
  230.         ===================================================================
  231.  
  232.         READDR takes three optional command line parameters as follows:
  233.  
  234.         1.   /N   Use  a different  filename for  the  READDR.BBS file.  The
  235.                   filename must follow immediately (no spaces)  after the /N
  236.                   parameter.  i.e.:   if  you   wanted  to   use  the   file
  237.                   MYNAMES.TXT in  place  of  READDR.BBS then  the  parameter
  238.                   would be "/NMYNAMES.TXT" In  all cases the file must be in
  239.                   the GTPATH directory.
  240.  
  241.         2.   /A   Use a file other than the  GTMDIR.BBS for the list of mail
  242.                   areas subject  to re-addressing. The  filename must follow
  243.                   immediately (no spaces)  after the /A parameter. i.e.:  if
  244.                   you  wanted  to  use the  file  NONECHO.BBS  in  place  of
  245.                   GTMDIR.BBS (as  I  do here)  then the  parameter would  be
  246.                   "/ANONECHO.BBS". In  all cases  the  file must  be in  the
  247.                   GTPATH directory.
  248.  
  249.         3.   /T   TestMode  switch.  When this  is on,  the program  runs in
  250.                   test mode  only.  No mail will be readdressed in this mode
  251.                   although all candidates  for readdressing  will be  found.
  252.                   Until  the program  is registered  this is  the  only mode
  253.                   which the program will run in.
  254.  
  255.  
  256.  
  257.                                     >> page 4 <<
  258.  
  259.  
  260.  
  261.  
  262.  
  263.  
  264.  
  265.         READDRESS: v2.00                                by Stephen de Plater
  266.         June 24, 1990                                    GT Power Net: 302/1
  267.  
  268.  
  269.  
  270.         Command line  parameters may be given in either upper or lower case,
  271.         and in  any order. The command  line parameter  switch character may
  272.         be either "/" or "-" (i.e.: "/Q" is the same as "-q").
  273.  
  274.         The parameters  must not be run  together (i.e.:  "/t /aMINE.TXT" is
  275.         fine, but "/t/aMINE.TXT" is wrong!)
  276.  
  277.  
  278.         ===================================================================
  279.         7.                           DISCLAIMER
  280.         ===================================================================
  281.  
  282.         Q:        What kind of guarantee comes with this software?
  283.  
  284.         A:                   *** ABSOLUTELY NONE!!! ***
  285.  
  286.         If you break it you get to keep both parts.
  287.  
  288.         I  take no responsibility at  all for what  this software  may do on
  289.         any computer other than my own. If you use it you do  so at your own
  290.         risk. All that I am prepared to  say about it is that it  works fine
  291.         here (and I can see no good reason why  it should not also work fine
  292.         everywhere else also -- but ....)
  293.  
  294.         By using this program you accept these conditions.
  295.  
  296.  
  297.         ===================================================================
  298.         8.                             ENJOY!
  299.         ===================================================================
  300.  
  301.         At least, I hope you do!
  302.         Stephen
  303.  
  304.  
  305.  
  306.  
  307.  
  308.  
  309.  
  310.  
  311.  
  312.  
  313.  
  314.  
  315.  
  316.  
  317.  
  318.  
  319.  
  320.  
  321.                                     >> page 5 <<
  322.